home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _graphics / graphics / _appdock2 / _help < prev    next >
Encoding:
Text File  |  1993-08-22  |  9.5 KB  |  210 lines
  1. > !AppDock2.!Help          Version 2.32     (28-Jul-93)
  2.  
  3. This is an application dock program which is similar to backdrop utilities,
  4. in that it allows application icons to be arranged in a nice way and the
  5. applications to be started without having to deal with directory windows.
  6. The design is similar to the Application Dock that forms part of the NeXT
  7. Step system on NeXT computers.
  8.  
  9. A totally new feature is the ShortCut bar. It works similarly to the
  10. application dock, but it stores ShortCuts for applications.
  11. You may define shortcuts for up to 20 applications. AppDock detects
  12. which application has the input focus and displays the shortcut
  13. definitions for the corresponding application. By clicking on one of
  14. the ShortCut buttons, the appropriate key combination is 'pressed' by
  15. the Application Dock.
  16.  You may edit the ShortCut definitions for each application. So, you
  17. may assign the ShortCut 'Find' and the key combination Ctrl-F4 to a
  18. button of the ShortCuts belonging to !Edit and if you click on the
  19. button while !Edit has the caret, the Find box is displayed.
  20.  
  21. How to use it:
  22.  
  23. 1.) the application dock
  24.  
  25. Simply drag an application or a directory on to one of the square buttons on
  26. the vertical bar on the left (or right) side of the desktop.
  27.  
  28. If you dragged an application:
  29. * its icon is shown on the button
  30. * double-clicking on it starts the application
  31. * dragging a file to it starts the application with the file given as
  32.   parameter
  33. * double-clicking with shift held down opens its directory
  34.  
  35. If you dragged a directory:
  36. (the same applies to a DOSDisc file or another image file if you are running
  37. RISC OS 3):
  38. * the name is shown on the button. 
  39. * as most names are too long to fit in one row, the application dock tries to
  40.   split the names at a sensible position, e.g. directory names as NewFiles
  41.   are split into 'New' and 'Files'.
  42. * double-clicking on it opens the directory
  43.  
  44. If you dragged a file to an application on the dock:
  45. * the application is started and the filename is given as parameter
  46.   (e.g. if you drag a file to the !Edit icon on the dock, !Edit is started
  47.   and the file is loaded).
  48.  
  49. You may define keyboard shortcuts for each entry in the dock, so that you
  50. are able to start them by one keystroke (if no other application intercepts
  51. the shortcut). Simply follow the submenu arrow of the second option of the
  52. main menu. The item is ticked if there is already a shortcut for the
  53. corresponding application/directory. Now select the key and the state of the
  54. control keys (none, Shift, Ctrl or Ctrl-Shift) and confirm the selection by
  55. clicking OK. You may cancel an existing shortcut by clicking on Off.
  56. Note that these shortcuts are not at all related to the shortcuts in
  57. the ShortCut bar.
  58.  
  59. Choosing 'Insert' causes one free button to be inserted before the button
  60. over which Menu was clicked.
  61.  
  62. Choosing 'Delete' causes the button over which Menu was clicked to be
  63. deleted.
  64.  
  65. Choosing 'Save all' from the menu saves the dock and the shortcuts defined
  66. in the ShortCut bar permanently (also saves the preferences).
  67.  
  68. Note that if you have many applications in the dock, loading may take some
  69. time, as the dock utility executes the !Boot file (or loads the !Sprites
  70. file if there is no !Boot file) of the applications in the dock (if they
  71. have not already be seen by the filer).
  72.  
  73.  
  74. 2.) The ShortCut bar
  75.  
  76. If the horizontal ShortCut bar is not on the screen, you may switch it on
  77. by obtaining the main menu of the application dock and choosing
  78. Prefs.ShortCuts.On
  79.  
  80. You may switch to edit mode by clicking Menu over the ShortCut bar and
  81. choosing Edit ... In the 'Edit shortcuts' window, you may browse
  82. through the defined applications by clicking the up/down arrow icons
  83. or you may define a new application by entering its name (the name
  84. shown in the Task Manager display, case sensitive !!) in the 'New
  85. application:' field and clicking the OK button next to it. Defined
  86. applications may be deleted by clicking the 'Delete' button.
  87.   Note that the ShortCut bar displays the shortcuts of the currently
  88. selected application.
  89.   By clicking Menu over one of the rectangular buttons of the ShortCut
  90. bar and following the submenu "ShortCut" you may edit the
  91. corresponding shortcut definition.
  92.   You may define the description of the ShortCut to be displayed on
  93. the bar by specifying it next to the text "Action:". Note that the
  94. maximum length for the description is 2 lines of 7 characters. You
  95. should leave a space where you want the lines to be split (e.g.
  96. 'Save file'). You may give the keystroke itself by positioning the
  97. caret in the small icon at the right of the text "ShortCut" and typing
  98. the corresponding key combination. You will hear the system bell and
  99. the key code will appear. Clicking on OK defines the shortcut.
  100.  
  101. Keystrokes which may be used:
  102.   
  103. Accepted keystrokes are generally all which have a RISC OS code:
  104.  * the function keys alone, with Ctrl, with Shift or with Ctrl-Shift
  105.  * all 'normal characters' from the keyboard
  106.  * Ctrl-A to Ctrl-Z (except Ctrl-U), Ctrl-[, Ctrl-], Ctrl-^, Ctrl-~
  107.  * arrow up/down, Ctrl + any of the arrow keys, Shift + arrow up/down
  108.  * some of the codes Alt+letter (not especially useful)
  109.  
  110. Additional keystrokes under RISC OS 3:
  111.  * Ctrl-U
  112.  * Delete, Copy, Shift-Copy, Ctrl-Copy
  113.  * arrow left/right (alone and + Shift)
  114.  
  115. Note that other keystrokes e.g. Ctrl-Shift-letter are not accepted, as
  116. they have no own character code. This is a pity as some programs (e.g.
  117. Impression and DeskEdit) make extensive use of Ctrl-Shift-letter
  118. combinations. However, to "send" such keystrokes to an application,
  119. much more effort is necessary.
  120.  
  121. The shortcut definition are saved by choosing 'Save all' from one of
  122. the menues.
  123.  
  124.  
  125. 3.) RISC OS 3
  126.  
  127. Former versions of AppDock disappeared if the RISC OS3 pinboard was
  128. switched on. This bug is fixed now. In some intermediate version the
  129. dock used to come to the front when Shift-F12 was pressed (like the icon bar).
  130. Unfortunately, this caused some problems, so this feature has been removed.
  131.  
  132.  
  133. 4.) Upgrading from Version 1 to Version 2
  134.  
  135. Simply copy your old !Dock file to the !AppDock2 directory and it
  136. should work. In the !ShortCuts file there is a basic sets of shortcuts
  137. for !Draw, !Edit !DeskEdit, !Impression and !ArtWorks. You may extend
  138. these, of course.
  139.  
  140.  
  141. 5.) Giving the application away
  142.  
  143. You are strongly advised to distribute AppDock and to give it to any
  144. Archimedes owners you know !
  145.   If you give the application away, it is best to delete the !Dock file,
  146. as the one who receives it will probably have his applications stored in
  147. different places on his hard disc, so if you start the dock containing
  148. your old !Dock file, the dock will complain as it won't find the apps
  149. mentioned in the file.
  150.  
  151. (It is no problem to maintain the shortcuts, as AppDock is not concerned
  152. whether or not you have the applications mentioned in the ShortCuts file).
  153.  
  154.  
  155. This application is FREEWARE, i.e. it may be copied freely, provided that
  156. no part of it is deleted or changed and that it is not sold for profit.
  157.  
  158. Author:
  159.  
  160. Martin Wuerthner
  161. Jahnstrasse 18
  162. D-71116 Gaertringen
  163. Germany
  164.  
  165. Phone:+049-7034-29262
  166. Fax:  +049-7034-21286
  167.  
  168.  
  169. Changes: Version 1.04: some bugs fixed
  170.          Version 1.05: now added Mode 20 icons
  171.          Version 1.06: o if a file is dragged to an application on the dock,
  172.                          the application is started with the filename as
  173.                          parameter
  174.                        o should now work better with RO3 as the window is
  175.                          re-opened if Ctrl-F11 is pressed
  176.          Version 1.10: o should now really work better with RO3 as the
  177.                          dock window doesn't disappear after returning
  178.                          from the command line
  179.                        o the dock comes to the front (like the icon bar)
  180.                          if Shift-F12 is pressed
  181.          Version 2.01: o ShortCut bar (automatic detection which app.
  182.                          has the input focus, editing facilities etc.)
  183.                        o new format (still reads version 1 !Dock files)
  184.                        
  185.          (Credits to Graham Hobson for his suggestion of the ShortCut bar)
  186.                          
  187.          Version 2.03: o Now accepts image files (e.g. DOSDisc files) and
  188.                          treats them as directories
  189.          Version 2.10: o Shift-F12-feature removed, as it interferes with
  190.                          the Pinboard (windows vanish if the Desktop is left
  191.                          using F12 while the dock is at the front).
  192.          Version 2.20: o Final version 2, posted to Newcastle
  193.          Version 2.21: o Small bug fix, posted to Newcastle
  194.          Version 2.30: o Wimp_Poll replaced by Wimp_PollIdle to reduce
  195.                          background processing time
  196.                        o Sorry for RISC OS 2 users who were confused because
  197.                          the RO2 sprite pool does not contain the 'up' and
  198.                          'down' arrow sprites which are used in the Edit
  199.                          Shortcuts window. They are now contained in the
  200.                          application's private sprite area
  201.          Version 2.31: o And I wondered why this new feature of RISC OS 3
  202.                          never worked ... I used the validation string N
  203.                          instead of KN, so you could not enter eg Ctrl-U as
  204.                          shortcut. This is now fixed, so under RISC OS 3
  205.                          you have some additional shortcuts (see above)
  206.          Version 2.32: o Now starts the !Run files of applications directly
  207.                          (starting the application itself does not work if it
  208.                           is within an image filing system like SparkFS)
  209.  
  210.